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PLEASE REVIEW THE TERMS OF THE FOUNDATION API LICENSE VERSION 1.0 
BEFORE READING THIS DOCUMENT. 


You may view the Foundation API License v1.0 at: 


http://www.limofoundation.org/images/stories/pdf/limo. foundation api. license v1-0.pdf 


This is an agreement between you (“You”) and LiMo Foundation related to the use of the APIs contained 
within this document. By accessing, downloading, reading or otherwise using the APIs contained within 
this document, You accept the terms of the Foundation API License v1.0. If You do not agree to the terms 
of this agreement, do not download, read and/or otherwise use any of the APIS. 


If You are agreeing to be bound by the Foundation API License v1.0 on behalf of your employer, You 
represent and warrant that you have full legal authority to bind your employer to this agreement. If You 
do not have the requisite authority, You may not download, read and/or otherwise use any of the APIs on 
behalf of your employer. 


O Copyright LiMo Foundation 2007, 2008. All rights reserved. 


NOTICES 


This document and the technical information it contains is subject to change by LiMo Foundation and 
its members at any time without notice as authorized by LiMo Foundation bylaws and other documents 
governing LiMo Foundation, including amendments thereto. All statements regarding LiMo’s future 
direction or intent are subject to change or withdrawal without notice, and represent goals and objectives 
only. 


Any reference in this document to non-LiMo Foundation Web sites do not in any manner serve as an 
endorsement of those Web sites. The materials at those Web sites are not part of this document or any 
product described in this document and use of those Web sites is at your own risk. 


Information concerning non-LiMo products was obtained from the suppliers of those products or a public 
announcement or source. LiMo cannot confirm the accuracy of that information or the performance, 
compatibility or any other claims related to non-LiMo products. 


All names or other identifying information used in examples in this document are fictitious and any 
similarity to the names or other identifying information of an actual person or organization is entirely 
coincidental. 


THIS DOCUMENT AND ALL INFORMATION IN THIS DOCUMENT ARE PROVIDED “AS IS”, 
WITHOUT ANY EXPRESS OR IMPLIED WARRANTY OR CONDITION, INCLUDING, BUT 
NOT LIMITED TO, ANY WARRANTY OR CONDITION OF ACCURACY OR COMPLETENESS, 
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR AGAINST INFRINGEMENT. 
ALL EXPRESS AND IMPLIED STATUTORY WARRANTIES ARE DISCLAIMED, INCLUDING 
WITHOUT LIMITATION, THE WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICU- 
LAR PURPOSE, TITLE OR NON-INFRINGEMENT. 
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Chapter 1 


DNET HTTP(S) Framework API 


1.1 References 


[1] Software Architecture Document, Version 1.1 Revision 1.4, LiMo Foundation, 11 September 2007 


1.2 Overview 


LiMo HTTP(S) Framework API. A function to resolve hostnames on the OEM platform and OpenSSL API 
for HTTPS. 


1.3 Industry Standard 


For LiMo Foundation Platform Release 1, HTTP Lib is designed to utilize OpenSSL for SSL functionality. 


1.4 External API Documents 


See http: //www.openssl.org/ 


1.5 Plug-in Extension Point Interface 
None 


e NetHttpResolveHost name resolution function. 


1.6 Other Interfaces 


OpenSSL v0.9.8 API for HTTPS functionality. 
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1.7 Other Notes 
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Chapter 2 


File Index 


2.1 File List 


Here is a list of all documented files with brief descriptions: 


ComponentOverview.h (Component Programming Interface Overview Header Template for 
Doxygen)’ erani dee tä caw ek mh eee hae Ghee Be 4 bu bo t 
http_porting.c (LiMo HTTP Porting functions) .................. e... 


File Index 
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Chapter 3 


File Documentation 


3.1 ComponentOverview.h File Reference 


3.1.1 Detailed Description 


Component Programming Interface Overview Header Template for Doxygen. 


This file contains configuration information for documentation generation; it does not contain any API- 
specific information. 
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3.2 http. porting.c File Reference 


3.2.1 Detailed Description 


LiMo HTTP Porting functions. 


include "http_internal.h" 


tinclude <netdb.h> 


Functions 


e int NetHttpResolveHost (const char *destname, int destport, const char *device, struct sockaddr 
**dest, int *xdest_len) 


Creates destination information from an IP address or by DNS query from host name. 


3.2.2 Function Documentation 


3.2.2.1 int NetHttpResolveHost (const char « destname, int destport, const char x device, struct 
sockaddr xx dest, int x dest_len) 


Creates destination information from an IP address or by DNS query from host name. 


Parameters: 


— destname Destination name. 

— destport Destination port number. 
— device Device name. 

— dest Destination information. 


— dest len Structure size of the destination information. 


Return values: 


NET_HTTP_RC_SUCCESS Success. 

negative-value Error. Reason code returned. 
NET_HTTP_RC_ERR_PARAM Abnormal termination. 
NET_HTTP_RC_ERR_DNS Abnormal termination. 
NET_HTTP_RC_ERR_GENERAL Abnormal termination. 


NET_HTTP_RC_ERR_PORTING An OEM specific error code between NET_HTTP_RC_ERR_- 
PORTING and NET_HTTP_RC_ERR_PORTING - 99. 


Note: 


This return value will be set as the error code of NET_HTTP_EV_TRANSACTION_ABORT or 
NET_HTTP_EV_SSL_CLOSE 
If NET_HTTP_RC_SUCCESS is returned, the memory for dest will be freed by the caller. 


Description: 


This function should be implemented by OEM so that it performs the following operations. 
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3.2 http porting.c File Reference T 


1. The destname can be a host name such as "www.yahoo.co.uk" or IP address in string notation such 
as "217.12.3.11." You have to cope with both of the formats. If it is a host name, obtain an IP address 
for the host name using DNS query. 

2. Allocate memory for "struct sockaddr" structure that is passed to socket function. Set the IP address 
obtained by DNS query and parameters to this function to that structure. 


The sample source uses gethostbyname for the DNS query. The OEM of HTTPLib must customize this 
function if needed to change the behaviour. 


Important Notes: 


destname contains the destination IP address or destination host name and must be terminated by 
NULL. 

The destport is the destination port number. The destination here means a proxy if you use a proxy or 
server 1f you don't use any proxy. 


The "device" is the name of a device to which the socket is bound to (eg. "pdp0"). If the passed device is 
NULL, handle it as if the OS default device is passed in. 


**dest is a structure passed to socket’s connect function. «dest_len is the size of the structure. 


This function should allocate the memory using http lib porting function MALLOC(). The caller of this 
function will free the memory. If this function returns an error, the memory should be released with FREE() 
in this function before returning. 


The struct sockaddr type is an abstract type. You have to pass a structure of a specific structure defined for 
each address family by casting it to (struct sockaddrx). For example use struct sockaddr_in for IPv4. 


See Linux man page for details of these address-family specific structures. For example, see ip(7) for IPv4 
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